home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.4 Applications 1997 August / SGI IRIX 6.4 Applications 1997 August.iso / dist / print.idb / usr / share / catman / u_man / cat1 / ilptops.z / ilptops
Encoding:
Text File  |  1997-07-30  |  21.2 KB  |  397 lines

  1.  
  2.  
  3.  
  4. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ilptops - convert a text file into a PostScript file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiillllppppttttooooppppssss [----BBBB #] [----CCCC n] [----DDDD] [----EEEE header]
  13.              [----FFFF fontlist] [----GGGG] [----HHHH] [----IIII #] [----JJJJ printer]
  14.              [----KKKK n] [----LLLL #] [----MMMM n] [----NNNN [tb][lcr]n]
  15.              [----OOOO #] [----PPPP #] [----QQQQ] [----RRRR #] [----TTTT #] [----UUUU]
  16.              [----VVVV] [----WWWW] [----XXXX] [----2222] [----aaaa] [----hhhh #] [----llll locale name]
  17.              [----mmmm map file] [----pppp bitmap size] [----wwww #] infiles
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _i_l_p_t_o_p_s converts a text file into a PostScript file for printing on an
  21.      Apple LaserWriter, or any other PostScript-compatible output device. It
  22.      supports selection of a variety of fonts at arbitrary point sizes, margin
  23.      specification, portrait and landscape page orientation, automatic page
  24.      numbering, page outlining, and multi-column printing. It is similar to
  25.      _i_l_p_t_o_p_s (1) except that it processes supplementary code set characters
  26.      according to the locale specified in the LC_CTYPE environment variables
  27.      [see LANG on environ(5)].  The ----llll options overrides LC_CTYPE. It also has
  28.      the capability to download bitmap and Type 1 fonts to printers.
  29.  
  30.      In the option descriptions below, physical dimensions described as # may
  31.      be specified as a single number with an optional fractional part, and a
  32.      required two-letter unit designator. Letter case is ignored. Possible
  33.      forms are:
  34.  
  35.             #.##bp   big point (1in=72bp)    [Courier: 120.000/Pbp cpi]
  36.             #.##cm   centimeter              [Courier: 4.233/Pcm cpi]
  37.             #.##in   inch                    [Courier: 1.667/Pin cpi]
  38.             #.##mm   millimeter (10mm=1cm)   [Courier: 42.333/Pmm cpi]
  39.             #.##pt   point (72.27pt=1in)     [Courier: 120.450/Ppt cpi]
  40.  
  41.      The bracketed values give the number of characters per inch (cpi) for a
  42.      point size of P units with the fixed-width Courier font.
  43.  
  44.      Options are parsed left to right. So, always the most recent option is
  45.      considered when there is a conflict. For example,
  46.  
  47.      iiiillllppppttttooooppppssss ----UUUU ----XXXX
  48.  
  49.      here, -X will be considered.
  50.  
  51.      The letter case is ignored in the options and the following options may
  52.      appear in any order.
  53.  
  54.      ----BBBB #### Bottom margin of #.
  55.  
  56.      ----CCCC nnnn Print _n copies of each page.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  71.  
  72.  
  73.  
  74.      ----DDDD   Use the Standard PostScript character set for text fonts. If this
  75.           option is not specified, the program will check whether the
  76.           specified font contains ISO 8859-1 (Latin-1) characters. If so, it
  77.           will use the ISO 8859-1 character set. Otherwise, it will use the
  78.           default character set for the specified font.
  79.  
  80.      ----EEEE hhhheeeeaaaaddddeeeerrrr
  81.           The header string will be used to print the gaudy header if ----GGGG
  82.           option is turned on. This flag has no effect if ----GGGG is not used.
  83.  
  84.      ----FFFF ffffoooonnnnttttlllliiiisssstttt
  85.           Comma seperated list of PostScript fontnames to be used with every
  86.           codeset. Possible values with acceptable short abbreviations (formed
  87.           from the upper-case letters in the font names) are as follows. The
  88.           following 35 typefaces are available on most of the PostScript
  89.           printers. Some old printers may support only the first 13 typefaces.
  90.  
  91.                       FFFFuuuullllllll NNNNaaaammmmeeee                      AAAAbbbbbbbbrrrreeeevvvviiiiaaaattttiiiioooonnnn
  92.                       ___________________________________________
  93.                       Courier                        C
  94.                       Courier-Bold                   CB
  95.                       Courier-BoldOblique            CBO
  96.                       Courier-Oblique                CO
  97.                       Helvetica                      H
  98.                       Helvetica-Bold                 HB
  99.                       Helvetica-BoldOblique          HBO
  100.                       Helvetica-Oblique              HO
  101.                       Symbol                         S
  102.                       Times-Bold                     TB
  103.                       Times-BoldItalic               TBI
  104.                       Times-Italic                   TI
  105.                       Times-Roman                    T
  106.  
  107.                       AvantGarde-Book                AGB
  108.                       AvantGarde-BookOblique         AGBO
  109.                       AvantGarde-Demi                AGD
  110.                       AvantGarde-DemiOblique         AGDO
  111.                       Bookman-Demi                   BD
  112.                       Bookman-DemiItalic             BDI
  113.                       Bookman-Light                  BL
  114.                       Bookman-LightItalic            BLI
  115.                       Helvetica-Narrow               HN
  116.                       Helvetica-Narrow-Bold          HNB
  117.                       Helvetica-Narrow-BoldOblique   HNBO
  118.                       Helvetica-Narrow-Oblique       HNO
  119.                       NewCenturySchlbk-Bold          NCSB
  120.                       NewCenturySchlbk-BoldItalic    NCSBI
  121.                       NewCenturySchlbk-Italic        NCSI
  122.                       NewCenturySchlbk-Roman         NCSR
  123.                       Palatino-Bold                  PB
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  137.  
  138.  
  139.  
  140.                       Palatino-BoldItalic            PBI
  141.                       Palatino-Italic                PI
  142.                       Palatino-Roman                 PR
  143.                       ZapfChancery-MediumItalic      ZCMI
  144.                       ZapfDingbats                   ZD
  145.  
  146.           The user is not limited to the above 35 typefaces. If there are any
  147.           additional fonts that have been downloaded into the PostScript
  148.           printer, then they can be used by specifying them through fontname.
  149.           If the requested font is not found, then the PostScript interpreter
  150.           will substitute it with a Courier font. Alternatively, the user can
  151.           opt to download fonts to the printer if the corresponding outline
  152.           font is not available int the printer..  The fontname is as
  153.           specified by the ps2xlfd_map.* file [ see type1xfonts(1) ] and the
  154.           download flag in the ilptops_map.* file shoule be 1.
  155.  
  156.           Only the Courier fonts have fixed widths like typewriter and line
  157.           printer fonts. The others are proportionally spaced for improved
  158.           readability, and consequently, tabular material will not line up
  159.           properly with them.
  160.  
  161.      ----GGGG   Turn on page decorations. Prints Date,Time,File name and Page
  162.           number. If a header is specified with the ----EEEE option, it will
  163.           override file name.
  164.  
  165.      ----HHHH   Horizontal page orientation (landscape mode) instead of vertical
  166.           page orientation (portrait mode).
  167.  
  168.      ----IIII #### Top margin of # for initial page (for letterheads); if not
  169.           specified, it will default to the value given for the top margin by
  170.           default or by the -T# command.
  171.  
  172.      ----JJJJ pppprrrriiiinnnntttteeeerrrr
  173.           The printer on which the document ( output ) is going to be printed.
  174.           The printer has to be installed on the system. If this option is not
  175.           specified, _i_l_p_t_o_p_s assumes 8.5x11in page size and 0.35in margins.
  176.  
  177.      ----KKKK nnnn The maximum number of lines to be printed on the page. Default is 66
  178.           lines.
  179.  
  180.      ----LLLL #### Left margin of #.
  181.  
  182.      ----MMMM nnnn Multiple column output (n columns). In multiple column mode,
  183.           formfeeds cause column breaks instead of page breaks.
  184.  
  185.      ----NNNN [[[[ttttbbbb]]]][[[[llllccccrrrr]]]]nnnn
  186.           Number output pages. The number is placed by default in the center
  187.           of the top margin, but the margin can be selected explicitly by t
  188.           (top) or b (bottom), and the position of the page number can be
  189.           further specified by l (left), c (center), or r (right).  If an
  190.           initial top margin value is given with the -I# option, numbering
  191.           will be omitted on the first page if it is at the top. Pages are
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  203.  
  204.  
  205.  
  206.           unnumbered if this option is not specified.
  207.  
  208.      ----OOOO #### Draw a # unit wide outline for pages/columns. In multi-column mode a
  209.           rectangular box is drawn around each column. A 0.4pt width outline
  210.           is an optimal choice for this option.
  211.  
  212.      ----PPPP #### Font point size. The point size also determines the interline
  213.           spacing.
  214.  
  215.      ----QQQQ   Turn on debug messages.
  216.  
  217.      ----RRRR #### Right margin of #.
  218.  
  219.      ----TTTT #### Top margin of #.
  220.  
  221.      ----UUUU   Output pages in unsorted (first to last) order instead of in sorted
  222.           (page reversed) order; some PostScript printers have page handlers
  223.           that stack the paper in this order. The default is sorted because
  224.           this is appropriate for the most common PostScript printer,the Apple
  225.           LaserWriter. Note that the newer Apple LaserWriter II series stacks
  226.           pages reversed. Therefore, the ----UUUU option should be used when sending
  227.           print jobs to a LaserWriter II printer.
  228.  
  229.      ----VVVV   Vertical page orientation (portrait mode) instead of Horizontal page
  230.           orientation (landscape mode).
  231.  
  232.      ----WWWW   Wraps long lines in the text instead of clipping them. _i_l_p_t_o_p_s reads
  233.           the character width information from fontmetric files in
  234.           /usr/lib/DPS/AFM to do the line width calculations. If the requested
  235.           font's fontmetrics file is not found, then _i_l_p_t_o_p_s ignores this
  236.           switch and defaults to clip mode. Default mode is to clip text in
  237.           long lines.
  238.  
  239.      ----XXXX   Output pages in sorted (last to first) order instead of in unsorted
  240.           (-U option) order; some printers have page handlers that stack the
  241.           paper in this order. The default is sorted because this is
  242.           appropriate for the most common PostScript printer, the Apple
  243.           LaserWriter.
  244.  
  245.      ----2222   Output PostScript file has Level 2 features.
  246.  
  247.      ----aaaa   Adjusts lines according to the rules in mmmmaaaapppp_f_i_l_e.  It has no effect
  248.           if the option -W is not used.
  249.  
  250.      ----hhhh #### Page height of #.
  251.  
  252.      ----llll llllooooccccaaaalllleeee____nnnnaaaammmmeeee
  253.           Locale name. Default is the environment variable LANG.
  254.  
  255.      ----mmmm mmmmaaaapppp____ffffiiiilllleeee
  256.           Default is /usr/lib/print/ilptops_map.<locale>.  Various locales
  257.           require their own map files. The map file includes font names,
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  269.  
  270.  
  271.  
  272.           download, AFM flag and rules in the following format.  Any line that
  273.           begins with a '#' is a comment. Columns are separated from by any
  274.           sequence of spaces or tabs.
  275.  
  276.           Lines 1 - 4 has 4 columns, _f_o_n_t__n_a_m_e , _o_f_f_s_e_t__v_a_l_u_e_s , _d_o_w_n_l_o_a_d__f_l_a_g
  277.           and _A_F_M__f_l_a_g a line each for each code set 0 - 3 respectively.
  278.           _f_o_n_t__n_a_m_e can be the font name of either a PostScript printer or
  279.           IRIX Font Manager. _o_f_f_s_e_t__v_a_l_u_e_s is a hexadecimal integer tells the
  280.           difference in character code between text code and printer.
  281.  
  282.              printer code = text code - _o_f_f_s_e_t__v_a_l_u_e
  283.  
  284.           _d_o_w_n_l_o_a_d__f_l_a_g indicates whether ilptops should download the font to
  285.           the printer.  With a value 1, the program generates Type 3 fonts in
  286.           the output PostScript file.  It optimises the amount of data sent to
  287.           the printer by generating only the part of the font which is
  288.           required for printing the input text file. With a value 2, it simply
  289.           copy Type 1 fonts in the PostScript file.  A value of 0 switches the
  290.           flag off.
  291.  
  292.           _A_F_M__f_l_a_g indicates whether ilptops should use AFM to calculate
  293.           character width or not.
  294.  
  295.           line 5 has 2 columns, _b_i_t_m_a_p__s_i_z_e and _s_i_d_e__b_e_a_r_i_n_g_s. _b_i_t_m_a_p__s_i_z_e
  296.           indicates the preferred size of bitmap used when generating the Type
  297.           3 font to be downloaded to the printer and _s_i_d_e__b_e_a_r_i_n_g_s is any
  298.           space that would be left around each character generated in the Type
  299.           3 font.  They have no effect if _d_o_w_n_l_o_a_d__f_l_a_g is off.
  300.  
  301.           Line 6 - 8 presents rules which are used to adjust wrapped lines.
  302.           Each line is a multi-byte character string. If the following
  303.           condition is satisfied, the line will be warped after current
  304.           character.
  305.  
  306.               {current character is in line 6} or
  307.               {{current character is not in line 7} and
  308.                {next character is not is line 8}}
  309.  
  310.           It has no effect if the option ----aaaa is not used.
  311.  
  312.           An example ilptops_map.cs files for the czech locale would be
  313.  
  314.  
  315.            #### ffffoooonnnnttttnnnnaaaammmmeeee      ooooffffffffsssseeeetttt  ddddoooowwwwnnnnllllooooaaaadddd____ffffllllaaaagggg   AAAAFFFFMMMM____ffffllllaaaagggg
  316.              FFFFiiiixxxxeeeedddd2222        0000xxxx0000     1111               0000
  317.              FFFFiiiixxxxeeeedddd2222        0000xxxx0000     1111               0000
  318.              CCCCoooouuuurrrriiiieeeerrrr       0000xxxx0000     2222               1111
  319.              CCCCoooouuuurrrriiiieeeerrrr       0000xxxx0000     0000               1111
  320.            #### ffffoooonnnntttt____ssssiiiizzzzeeee     ssssiiiiddddeeee____bbbbeeeeaaaarrrriiiinnnnggggssss
  321.              22224444            0000
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  335.  
  336.  
  337.  
  338.           The fontname Fixed2 in this example could have a specification in
  339.           the file ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////ffffoooonnnnttttssss////ppppssss2222xxxxllllffffdddd____mmmmaaaapppp....llllaaaattttiiiinnnn2222 aaaassss
  340.  
  341.            #### ppppssss2222xxxxllllffffdddd____mmmmaaaapppp....llllaaaattttiiiinnnn2222
  342.            ####
  343.            #### TTTThhhhiiiissss ffffiiiilllleeee iiiissss aaaa mmmmaaaappppppppiiiinnnngggg ooooffff PPPPoooossssttttSSSSccccrrrriiiipppptttt aaaannnndddd #### FFFFoooonnnntttt MMMMaaaannnnaaaaggggeeeerrrr ((((FFFFMMMM))))
  344.            #### ffffoooonnnntttt nnnnaaaammmmeeeessss ttttoooo tttteeeemmmmppppllllaaaatttteeeessss #### ffffoooorrrr 11114444----ppppaaaarrrrtttt ((((XXXXLLLLFFFFDDDD)))) XXXX ffffoooonnnntttt nnnnaaaammmmeeeessss....
  345.            ####
  346.            #### TTTThhhheeee ffffoooorrrrmmmmaaaatttt ooooffff eeeeaaaacccchhhh lllliiiinnnneeee iiiissss::::
  347.            ####
  348.            #### <<<<ffffoooonnnnttttnnnnaaaammmmeeee>>>> <<<<wwwwhhhhiiiitttteeeessssppppaaaacccceeee>>>> <<<<XXXXLLLLFFFFDDDDffffoooonnnnttttnnnnaaaammmmeeee>>>> <<<<nnnneeeewwwwlllliiiinnnneeee>>>>
  349.            ####
  350.            #### TTTThhhheeee XXXXLLLLFFFFDDDDffffoooonnnnttttnnnnaaaammmmeeee iiiissss aaaannnn XXXXLLLLFFFFDDDD tttteeeemmmmppppllllaaaatttteeee....  TTTThhhheeee vvvvaaaalllluuuueeeessss ooooffff::::
  351.            ####     PPPPIIIIXXXXEEEELLLL____SSSSIIIIZZZZEEEE
  352.            ####     PPPPOOOOIIIINNNNTTTT____SSSSIIIIZZZZEEEE
  353.            ####     RRRREEEESSSSOOOOLLLLUUUUTTTTIIIIOOOONNNN____XXXX
  354.            ####     RRRREEEESSSSOOOOLLLLUUUUTTTTIIIIOOOONNNN____YYYY
  355.            #### aaaarrrreeee sssseeeetttt ttttoooo 0000....
  356.            ####
  357.            FFFFiiiixxxxeeeedddd2222        ----ssssggggiiii----ffffiiiixxxxeeeedddd----mmmmeeeeddddiiiiuuuummmm----rrrr----nnnnoooorrrrmmmmaaaallll--------0000----0000----0000----0000----cccc----0000----iiiissssoooo8888888855559999----2222
  358.            FFFFiiiixxxxeeeedddd2222----BBBBoooolllldddd   ----ssssggggiiii----ffffiiiixxxxeeeedddd----bbbboooolllldddd----rrrr----nnnnoooorrrrmmmmaaaallll--------0000----0000----0000----0000----cccc----0000----iiiissssoooo8888888855559999----2222
  359.  
  360.  
  361.      ----pppp nnnn Bitmap size used for generating Type 3 fonts. It has no effect if
  362.           _d_o_w_n_l_o_a_d__f_l_a_g is off.
  363.  
  364.      ----wwww #### Page width of #.
  365.  
  366.      DDDDeeeeffffaaaauuuullllttttssss aaaarrrreeee::::
  367.  
  368.           _i_l_p_t_o_p_s -B0.35in -C1 -FCourier -K66 -L0.35in -M1 -R0.35in -T0.35in
  369.           -X -h11.0in -w8.0in
  370.  
  371. BBBBUUUUGGGGSSSS
  372.      Currently, _i_l_p_t_o_p_s is not able to handle files that generate more than
  373.      1024 total pages.
  374.  
  375. FFFFIIIILLLLEEEESSSS
  376.      /usr/lib/print/ilptops
  377.                            filter to convert text to PostScript.
  378.  
  379.      /usr/lib/print/ilptops_map.<locale>
  380.                            Locale dependent map files.
  381.  
  382. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  383.      lp(1)
  384.      lptops(1)
  385.      type1xfonts(1)
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.